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FOREWORD 

This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 


The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 

ROLE 

Control  Data  Corporation 

Responsible  for  the  overall  Common 

Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

D.  Appleton  Company 

Responsible  for  providing  software 
information  services  for  the  Common 

Data  Model  and  IDEFIX  integration 
methodology . 

ONTEK 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Simpact  Corporation 

Responsible  for  Communication 
development . 
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Structural  Dynamics  Responsible  for  User  Interfaces, 

Research  Corporation  Virtual  Terminal  Interface, and  Network 

Transaction  Manager  design, 
development,  implementation,  and 
support . 

Arizona  State  University  Responsible  for  test  bed  operations 

and  support. 
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INTRODUCTION 


The  NDDL  Translator  is  a  utility  for  translating  the  native 
Data  Definition  Language  (DDL)  for  DATABASE  2  and  TOTAL  data 
base  management  systems  into  the  IISS  Neutral  Data  Definition 
Language  (NDDL)  for  the  creation  of  the  Internal  Schema  (IS) 
specification  for  the  Common  Data  Model  (CDM) . 

The  NDDL  Translator  consists  of  several  translators,  one 
for  each  DDL  which  must  be  translated  to  NDDL.  Each  translator 
differs  only  in  its  lexical  anaylzer  and  parser;  so  to  avoid 
confusion  this  document  will  refer  to  these  translators 
collectively  as  "the  translator". 

The  translator  accepts  the  subset  of  the  native  DDL  which 
pertains  to  initial  database  definition.  While  all  of  the 
subset  is  accepted,  only  entities  within  the  subset  which  have 
NDDL  eguivalents  are  translated  (e.g.  defining  a  file  of  a 
database  is  translated  but  the  type  of  disk  drive  is  accepted 
and  ignored) .  The  translator  checks  the  syntax  of  the  input  but 
assumes  the  semantics  are  correct  for  the  appropriate  DDL.  The 
grammar  generated  by  the  translator  is  given  in  Appendix  A. 

Intended  Audience 

This  document  is  intended  to  be  used  by  CDM  administrators 
(CDMA) ,  those  who  are  responsible  for  making  changes  to  the  CDM 
and  ensuring  it  remains  in  a  consistent  state. 
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DOCUMENTS 


2 . 1  Reference  Documents 

[1]  SYSTRAN,  ICAM  Documentation  Standards,  IDS150120000C, 
15  September  1983. 

[21  D.  Appleton  Company.  CDM  Administrator's  Manual,  UM 
620341000,  31  May  1988. 

[3]  D.  Appleton  Company,  CDMl,  An  IDEFl  Model  of  the 
Common  Data  Model .  CCS  620341000,  31  May  1988. 

[4]  Control  Data  Corporation,  Neutral  Data  Definition 
Language  User's  Guide,  1  November,  1987. 

[5]  C.  J.  Date,  ^  Introduction  to  Database  Systems,  1977, 
Addison-Wesley  Publishing  Company,  Inc. 

[6]  IBM,  DATABASE  2  Reference  Release  1.0,  December  1984 

[7]  Cincom  Systems,  TOTAL  Database  Administration 
Reference  Manual ,  Release  8.1,  1978 

2 . 2  Terms  and  Abbreviations 

Application  Process ;  (AP) ,  a  cohesive  unit  of  software 
that  can  be  initiated  as  a  unit  to  perform  some  function  or 
functions. 

Common  Data  Model ;  (CDM) ,  IISS  subsystem  that  describes 
common  data  of  an  enterprise  and  includes  conceptual, 
external  and  internal  schemas  and  schema  transformations. 

Common  Data  Model  Administrator:  (CDMA) ,  the  person  or 
group  of  persons  responsible  for  creating  and  maintaining  an 
enterprises ' s  Common  Data  Model.  The  CDMA  manages  the  common 
data  rather  than  managing  applications  that  access  data. 

Common  Data  Model  Processor:  (CDMP) ,  a  component  of  the 
Common  Data  Model  subsystem  which  is  the  distributed  database 
manager  of  the  IISS. 

Conceptual  Schema:  (CS) ,  the  standard  definition  used 
for  all  data  in  the  CDM.  It  is  based  on  IDEFl  information 
modelling. 

External  Schema:  (ES) ,  an  application's  view  of  the 
CDM's  conceptual  schema. 

Integrated  Info^ation  Support  System:  (IISS) ,  a  computing 
environment  used  to  investigate,  demonstrate,  test  the  concepts 
and  produce  application  for  information  management  and 
information  integration  in  the  context  of  Aerospace 
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Manufacturing.  The  IISS  addresses  the  problems  of  integration 
of  data  resident  on  heterogeneous  data  bases  supported  by 
heterogeneous  computers  interconnected  via  a  Local  Area  Network. 

Internal  Schema:  (IS) ,  the  definition  of  the  internal 
model,  the  storage  structure  definition,  which  specifies  how 
the  physical  data  are  stored  and  how  they  can  be  accessed.  It 
is  represented  in  terms  of  the  physical  database  components, 
including  record  types  and  inter-record  relationships. 

Neutral  Data  Definition  Language i  (NDDL) ,  A  language 
used  to  manipulate  and  populate  information  in  the  Common 
Data  Model  (CDM)  or  IISS  System  Database. 

Neutral  Data  Manipulation  Language :  (NDML) ,  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieval,  single  node 
update,  and  non-guaranteed  distributed  update. 

Presentation  Schema :  (PS) ,  The  totality  of  the  form 
fields  in  an  application  which  are  targets  of  data  derivative 
from  the  common  data. 
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USE  OF  THE  TRANSLATOR 


3 . 1  Translator  Input/Output 

The  translator  takes  as  input  the  DDL  of  either  DATABASE  2 
or  TOTAL.  The  input  is  restricted  to  functions  which  pertain  to 
initial  database  definition  and  not  incremental  changes.  The 
grammar  of  each  Data  Base  Management  System  (DBMS)  the 
translator  accepts  is  listed  in  Appendices  B  and  C. 

The  output  of  the  translator  is  a  source  text  file  of  NDDL 
which  pertains  to  the  definition  of  an  IS  for  the  CDM.  The 
output  source  will  be  syntactically  correct  but  may  be 
semantically  incomplete.  Missing  items  are  flagged  in  the 
generated  source  by  comments  and  in  some  cases  will  be  supplied 
with  dummy  default  values.  The  CDMA  must  supply  such  things  as 
the  NTM  host.  The  forms  interface  to  the  NDDL  processor 
(another  CPCI)  allows  you  to  perform  stepwise  refinement  of  the 
output  NDDL  in  order  to  semantically  complete  the  NDDL.  The 
grammar  for  the  output  of  the  translator  is  given  in  Appendix  A. 

3 . 2  How  to  Run  the  NDDL  Translator  Program 

The  translator  is  run  from  the  IISS  Function  Screen.  Its 
name  is  ''DB2TRANZ''  for  DATABASE  2  and  "TOTTRANZ"  for  TOTAL.  When 
the  translator  starts,  the  form  shown  in  Figure  3-1  is 
presented.  The  CDMA  enters  the  name  of  the  input  file  to  be 
translated  and  the  name  of  the  output  file  to  receive  the 
translated  source. 


+ - - 

DDL  TO  NDDL  TRANSLATOR 


Input  File 
Output  File 


Msg; 


applcation 


Figure  3-1  User  Interface  Screen  for  Translator 
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Error  messages  from  the  translator  are  presented  in  the 
message  line  and  are  of  the  following  form: 

error  line  number:  message  text 

where  the  error  type  is  either  WARNING,  ERROR,  or  FATAL. 

A  WARNING  message  indicates  a  problem  but  does  not  prevent 
translation  to  NDDL.  An  ERROR  message  indicates  a  problem  which 
does  prevent  translation.  After  an  error  is  found  the 
translator  continues  reading  the  input  file  so  that  further 
errors  in  the  text  (if  there  are  any)  can  be  found;  but  no  NDDL 
translation  is  generated.  A  FATAL  message  indicates  a  problem 
which  prevents  translation  and  causes  the  termination  of  the 
translator.  The  line  number  is  the  number  of  the  line  in  the 
input  file  where  the  error  occured.  The  message  text  is  a 
description  of  the  error.  A  list  of  error  messages  is 
documented  in  Appendix  D. 

3.3  Refinement  of  the  Generated  NDDL  Code 


Since  the  generated  NDDL  code  is  sometimes  semantically 
incomplete,  the  NDDL  code  is  refined  via  the  NDDL  interactive 
processor  with  translator-issued  modification  requirements  as  a 
guide.  The  modification  requirements  are  in  the  form  of 
comments  embedded  in  the  generated  NDDL.  They  immediately 
follow  the  entry  to  be  modified.  Their  format  is  as  follows: 

/*  MOD  -  message  text  */ 

These  messages  are  documented  along  with  the  related  NDDL 
statements  in  Appendix  A.  Some  examples  are: 

For  DATABASE  2: 

define  DB2  database  named  DGN8DPRG  on  host  dummy; 

/*  MOD  -  host  name  */ 

For  TOTAL: 

define  TOTAL  database  named  ORDRDB  on  host  dummy; 

/*  MOD  -  host  name  */ 

For  more  information  concerning  the  NDDL  interactive  processor 
refer  to  the  NDDL  User's  Guide  for  that  module. 
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NDDL  Grammar 


These  are  the  NDDL  commands  that  may  be  generated  by  the 
translator.  Each  command  is  listed  for  DATABASE  2  and  TOTAL. 
Version  2.3  of  NDDL  is  used.  In  the  following  a  word  that 
begins  with  a  capital  letter  is  a  keyword  and  must  be  typed  in 
exactly  as  it  appears.  An  all  lower  case  word  is  a  name 
supplied  by  the  user.  A  token  which  appears  in  braces  {  > 
indicates  one  must  be  selected.  A  token  which  appears  in 
brackets  []  indicates  the  entity  is  optional.  A  token  which  is 
followed  by  an  elipsis  indicates  the  entity  may  be  repeated. 

Define  Database 

DB2 


-  Define  DB2  Database  Named  db_name  On  Host  hcst_name; 

Note:  A  modification  requirement  will  be  issued  for  the 
user  to  supply  a  host  name. 

TOTAL 

-  Define  TOTAL  Database  Named  db_name  On  Host  host_name 
With  Files  file_name  ...  ; 

Note:  A  modification  requirement  will  be  issued  for  the 
user  to  supply  a  host  name. 

Define  Table 


DB2 


-  Define  Table  table_id 
With  Columns 

{  column_name  Datatype  data_type_name  )  ...  ; 


Note:  SQL  data  types  will 
SQL 

INTEGER 

SMALLINT 

FLOAT 

DECIMAL (n,m) 

CHAR(n) 

VARCHAR(n) 

LONGVARCHAR 


be  translated  as  follows: 

NDDL 

INTEGER 

SMALLINT 

FLOAT 

DECIMALnnn_mmm 

CHARnnn 

VARCHARnnn 

LONGVARCHAR 
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TOTAL 


-  Define  Table  table_id 
With  Columns 

/  [level_no]  column_name_l  \ 

/  Datatype  data_type_name  [Unique  Key]  \ 

<  Redefines  column_name_2  > 

<  \  Unknown  /  > 


I  [level_no]  Filler  filler_size 

\ 


/ 


Note:  A  modification  requirement  will  be  issued  for  each 
filler  field  to  use  a  named  field. 

Define  Set 

DB2 


-  Not  Applicable 
TOTAL 

-  Define  Set  set_name 

From  table_idl  to  table_id2  . . . 
Linked  By  column_name; 

Note:  column_name  is  from  table_idl. 

Describe 

-  Describe  Comment_On  Of 

/  Table  Class  table_id  \ 

\  Column  Class  column_name  / 
"string"  ; 
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APPENDIX  B 
DATABASE  2  Syntax 


The  following  are  DATABASE  2  commands  that  could  appear  in 
a  database  definition.  In  the  following  a  word  that  begins  with 
a  capital  letter  is  a  keyword  and  must  be  typed  in  exactly  as  it 
appears.  An  all  lower  case  word  is  a  name  supplied  by  the  user. 
A  token  which  appears  in  braces  {  }  indicates  one  must  be 
selected.  A  token  which  appears  in  brackets  []  indicates  the 
entity  is  optional.  An  entity  which  is  followed  by  an  elipsis 
indicates  the  token  may  be  repeated.  Note  that  several 
databases  and  tables  may  be  defined  in  one  source  file. 


Create  Database  (maps  to  NDDL  Define  Database) 
Create  Database  db  name 


Create  Table  (maps  to  NDDL  Define  Table) 

Create  Table  table_id 

(  {  column  name  data_type  [  Not  Null  ]  }  , . . .  ) 
/  In  [  3b_name.  ]  tablespace_name  \ 

\  In  Database  db_name  / 


Comment  On  (maps  to  NDDL  Describe) 

Comment  On  /  Table  table_id  \ 

\  Column  table  id. column  name  / 

"string” 

Commands  that  may  appear  in  DDL. 

Create  Index 
Create  Stogroup 
Create  Synonym 
Create  Tablespace 
Create  View 
Grant  (privileges) 
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Total  DDL  Syntax 


The  following  are  statements  from  the  TOTAL  DDL  which  could 
appear  in  a  database  definition.  TOTAL  is  a  fixed  format  line 
oriented  language  and  could  be  parsed  by  little  more  than  a 
lexical  analyzer.  Statements  which  map  to  NDDL  are  prefixed  by 
a  star.  In  the  following  a  word  that  begins  with  a  capital 
letter  is  a  keyword  and  must  be  typed  in  exactly  as  it  appears. 
An  all  lower  case  word  is  a  name  supplied  by  the  user.  A  name 
of  mmmm  indicates  a  master  table  name.  A  name  of  ww  indicates 
a  variable  table  name.  A  token  which  appears  in  braces  {  ) 
indicates  one  must  be  selected.  A  token  which  appears  in 
brackets  []  indicates  the  entity  is  optional.  A  token  which  is 
followed  by  an  elipsis  indicates  the  entity  may  be  repeated. 

The  notation  ".pp.”  indicates  a  level  number  for  a  column  (e.g. 
a  COBOL  record) . 

Note  that  one  database  and  several  master  and  variable 
tables  may  be  defined  in  one  source  file.  All  TOTAL  data  fields 
will  be  of  the  data  type  CHAR^n  (where  n  is  the  size  in  bytes  of 
the  field.  A  warning  will  be  issued  for  the  user  to  modify  these 
fields.  All  filler  fields  will  be  flagged  as  warnings  as  fillers 
should  not  be  used.  The  data  definition  should  not  contain 
fillers,  use  the  database  definition  which  has  all  fields  named. 
In  variable  records  the  record  code  redefines  the  last  data 
field  in  the  base  data  section.  The  level  numbers  will  be 
incremented  by  one  to  handle  redefinition  of  variable  data 
areas.  Link  and  key  fields  which  have  secondary  names  will  have 
the  secondary  name  treated  as  a  redefinition  of  the  field. 


BEGIN-DATA-BASE-GENERATION : 

OPTIONS:  ... 

LOGGING:  ... 

CTLX :  ... 

*  DATA-BASE-NAME  =  xxxxxxxx  ;  Maps  to  NDDL  Define  Database 


SHARE-IO:  ... 
lOAREA  =  . . . 

J  CL  —  ... 

BEGIN-MASTER-DATA-SET : 
*  DATA-SET-NAME  =  mmmm 
lOAREA  =  XXXX 


MASTER-DATA: 

*  [•??•]  nunmmROOT  =  8 

*  [ • PP • ]  mmmmCTRL  =  n 

*  [  [  •  PP  •  ]  iwnmmLKxx  =  8  ] 

*  [['PP']  xxxxxxxx  [=  n]] 

*  [ [ -PP- ]  *FILLER*  =  n] 
END-DATA: 

DEVICE  =  . . . 

ACCESS -METHOD  =  . .  . 
TOTAL-  LOGICAL-RECORD  = 
TOTAL-TRACKS  =  . . . 


;  Maps  to  Define  Database 


;  Maps  to  Define  Table 

;  named  data  field 
;  named  data,  key  field 
;  named  data,  link  field 
;  named  data  or  unknown  field 
;  unnamed  data  field 

;  Physical  data  description 
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LOGICAL-RECORD-LENGTH  =  . . . 

LOGICAL-BLOCKS-PER-TRACK  =  . . . 

CONTROL- INTERVAL  =  . . . 

CONTROL-INTERVAL-SIZE  =  . . . 

DISK-EXTENTS  =  . . . 

DOS  =  ... 

OLD-FILE  =  .  .  . 

END-MASTER-DATA-SET : 

BEGIN-VARIABLE-ENTRY-DATA-SET : 

*  DATA-SET-NAME  =  ww  ;  File  of  Define  Database 

lOAREA  =  ... 

;  Maps  to  Define  Table 

BASE -DATA: 

*  [[‘PP*]  wwCODE  =  2]  ;  named  data  field 

*  [-pp-]  xxxxxxxx  =  n  [=mmmmCTRL] 

;  named  data  field  associated 
with  key 

*  [[‘PP*]  *FILLER*  =  n]  ;  unnamed  data  field 

*  [ . pp . ] mmmmLKxx  =  8  [=xxxxxxxx] 

;  named  data,  link  field  of 
master  record 

*  RECORD-CODE  =  XX  ;  named  redefines  field 

*  [-PP*]  xxxxxxxx  =  n  [=mmmmCTRL] 

;  named  data  field  associated 
with  key  ?  is  it  unique? 

*  [[‘PP*]  *FILLER*  =  n]  ;  unnamed  data  field 

*  [ • PP • ] mmmmLKxx  =  8  [ =xxxxxxxx ] 

;  link  field  of  master  record 

END-DATA: 

;  Physical  data  description 


DEVICE  =  . . . 

ACCESS-METHOD  =  . .  . 

TOTAL-  LOGICAL-RECORD  =  . . . 
TOTAL-TRACKS  =  . . . 
LOGICAL-RECORD-LENGTH  =  . . . 
LOGICAL-BLOCKS-PER-TRACK  =  . . . 
CONTROL-INTERVAL  =  . . . 
CONTROL-INTERVAL-SIZE  =  . . . 
DISK-EXTENTS  =  . . . 

EXDS  =  ... 

OLD-FILE  =  . . . 

END-VARIABLE-ENTRY-DATA-SET : 
END-DATA-BASE-GENERATION : 
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User  Interface  Error  Messages 

The  following  are  a  list  of  error  messages  which 
presented  when  using  the  translator.  A  percent  sign 
preceding  a  name  indicates  the  value  of  the  name  will 
substituted. 

WARNING  n;  string  too  long 

A  string  is  longer  than  160  characters. 

ERROR  n:  Unable  to  open  %file_name 

The  translator  was  unable  to  open  the  file. 

•  ERROR  n:  unterminated  string 

A  string  has  no  closing  quote. 

ERROR  n:  syntax  error 

•  There  is  a  syntax  error  on  the  given  line. 

FATAL  n:  out  of  memory 

The  translator  was  unable  to  allocate  sufficient 


« 


could  be 

(%) 

be 


memory . 
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